Skip to content

Technical review: Add doc for the scope_extensions manifest member #39649

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: main
Choose a base branch
from

Conversation

chrisdavidmills
Copy link
Contributor

Description

Chrome 138 supports the scope_extensions webapp manifest member; see https://chromestatus.com/feature/5746537956114432 for details.

This PR adds a reference page for the new member.

Motivation

Additional details

Related issues and pull requests

@chrisdavidmills chrisdavidmills requested a review from a team as a code owner May 23, 2025 15:34
@chrisdavidmills chrisdavidmills requested review from pepelsbey and removed request for a team May 23, 2025 15:34
@github-actions github-actions bot added the Content:PWA Progressive Web Apps content label May 23, 2025
@chrisdavidmills chrisdavidmills changed the title Add doc for the scope_extensions manifest member Technical review: Add doc for the scope_extensions manifest member May 23, 2025
@github-actions github-actions bot added the size/m [PR only] 51-500 LoC changed label May 23, 2025
Copy link
Contributor

github-actions bot commented May 23, 2025

Preview URLs

External URLs (2)

URL: /en-US/docs/Web/Progressive_web_apps/Manifest/Reference/scope_extensions
Title: scope_extensions

(comment last updated: 2025-05-28 09:48:00)


The value of each property is an object containing a `scope` property with a value specifying the exact path that will be in-scope for the referencing web app.

EDITORIAL: I'M ASSUMING YOU CAN INCLUDE MULTIPLE FIELDS IN THE WELL-KNOWN FILE, TO OPT-IN TO THE SCOPE OF MULTIPLE WEB APPS, OR INCLUDE DIFFERENT SCOPES IN THE SCOPE OF A SINGLE WEB APP?
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is correct in the first part. Scenario:

  • Foo App at www.foo.com, manifest id of https://www.foo.com
  • Foo App Beta at beta.foo.com, manifest id of https://beta.foo.com
  • Both extend their scope to included https://help.foo.com, which is the help portal.
  • Thus, the help.foo.com's .well-known file will contain both manifest ids.

Since this is a dictionary, it's not possible to have multiple entries for the same manifest id.

@LuHuangMSFT to double check me

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @dmurph. This makes total sense, so I've updated the docs and removed the editorial note.

@LuHuangMSFT, please let me know if you have any further comments on this PR. Thanks!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Content:PWA Progressive Web Apps content size/m [PR only] 51-500 LoC changed
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants